home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / maximus / vk_299b.zip / VKILL.DOC < prev    next >
Text File  |  1992-10-01  |  9KB  |  188 lines
  1. ╓─┐    ╓─┐ ╓─┐ ╓──┐ ╓───┐ ╓─┐    ╓─┐     ╓─────┐     ╓─────┐ ╓─────┐ ╓──────┐
  2. ║ │    ║ │ ║ │╓╜ ╒╛ ╚╗ ╒╛ ║ │    ║ │     ╚═══╗ │     ║ ╒═╗ │ ║ ╒═╗ │ ║ ╒══╗ │
  3. ╚╗└┐  ╓╜╒╛ ║ └╜ └─┐  ║ │  ║ │    ║ │     ╓───╜ │     ║ └─╜ │ ║ └─╜ │ ║ └──╜ │
  4.  ╚╗└┐╓╜╒╛  ║ ╒══╗ │  ║ │  ║ │    ║ │     ║ ╒═══╛     ╚═══╗ │ ╚═══╗ │ ║ ╒══╗ │
  5.   ╚╗└╜╒╛   ║ │  ║ │ ╓╜ └┐ ║ └──┐ ║ └──┐  ║ └───┐ ╓─┐  ╓──╜ │  ╓──╜ │ ║ │  ║ │
  6.    ╚══╛    ╚═╛  ╚═╛ ╚═══╛ ╚════╛ ╚════╛  ╚═════╛ ╚═╛  ╚════╛  ╚════╛ ╚═╛  ╚═╛
  7. ─────────────────────────────────────────────────────────────────────────────
  8.   (C)opyright 1992, Scott Burkett, Christopher Brown, Cairo Research Labs.
  9. ─────────────────────────────────────────────────────────────────────────────
  10.  
  11.                   ┌───────────────────────────────────────┐
  12.                   │             Version 2.99b             │
  13.               ████│       Alpha Release Date 09/18/92     │▓███
  14.                   └───────────────────────────────────────┘
  15.  
  16. ─────────────────────────────────────────────────────────────────────────────
  17. ■ INTRODUCTION ■
  18. ─────────────────────────────────────────────────────────────────────────────
  19.  
  20. VKill is an automated Virus/Archive scanner designed for use with Scott
  21. Dudley's Maximus CBCS.  It's features include:
  22.  
  23.         * Capability of handling an unlimited amount of nested archives
  24.         * Fully configureable to facilitate archiver/scanner updates
  25.         * Test archives and/or contents of archives against a date stamp
  26.           to provide a method of preventing users from getting credit by
  27.           by uploading out-of-date or old archives.
  28.         * Will not accept archives other than the types you specify!
  29.         * Special Extension handling (i.e. GIF, PCX, MOD, VOC, etc).
  30.         * Eye-pleasing status report for your users to view as VKill works!
  31.  
  32. ─────────────────────────────────────────────────────────────────────────────
  33. ■ WHATS NEW IN RELEASE 2.99B? ■
  34. ─────────────────────────────────────────────────────────────────────────────
  35.  
  36.      o BUGFIX:  Weird things happened (dependant upon your system) when
  37.        a user uploaded a bad file.  The majority of the time, the file
  38.        vanished (instead of being properly moved, etc). This bug has been
  39.        an ongoing problem with VKill, and has finally been fixed!
  40.  
  41.      o Added DEBUG mode, which (when enabled) will log VKill debug info
  42.        to your VKILLx.LOG file, to help track down future problems.
  43.  
  44.      o VKill now performs a check first to see if the passed filename
  45.        actually resides in the upload directory.  Maximus shouldn't screw
  46.        this up, but when performing local mode tests, it can save you from
  47.        running VKill inadvertently because of a typo, etc.
  48.  
  49. ─────────────────────────────────────────────────────────────────────────────
  50. ■ A BRIEF BLURB FROM THE AUTHORS ■
  51. ─────────────────────────────────────────────────────────────────────────────
  52.  
  53. Since the last release of VKill (2.00), several minor (major!) bugs were
  54. found. To the best of our knowledge, they have been squashed, and should not
  55. cause you any more grief.  We have quite a bit in store for VKill in the
  56. future, including possible version releases for other major BBS packages.
  57. This pre 3.0 alpha release is just that, an alpha release!  We wanted to get
  58. a bit of feedback from the growing horde of Maximus CBCS Sysops, before the
  59. 3.0 release hits the door.
  60.  
  61. Because of this, we have included a program entitled KEYGEN.EXE, which will
  62. allow you to create your own registration key for the alpha test version.
  63. VKill is fully functional regardless of whether or not it finds a valid key,
  64. but you get to see your name in lights... ;-)
  65.  
  66. A complete user manual is being prepared, as is a companion utility entitled
  67. VKMaint (more on this guy later!).  Please excuse the rudimentary docs.
  68.  
  69. Thanks for taking the time to review the VKill system, and I hope that it
  70. serves you justice (or shall I say, serve your USERS justice? ;-) )
  71.  
  72. ─────────────────────────────────────────────────────────────────────────────
  73. ■ VKILL OPERATION ■
  74. ─────────────────────────────────────────────────────────────────────────────
  75.  
  76. Operating VKill is a cinch.  When a user completes an upload session, Maximus
  77. will call a batch file called VIRCHECK.BAT.  Simply place VKill in this batch
  78. file and let her go.  A sample VIRCHECK.BAT file should be included with this
  79. archive.
  80.  
  81. VKill processes the uploaded file based upon the extension of the file.  All
  82. you have to do is ensure that the popular archivers are available in your
  83. path, (i.e. PKZIP, LHARC, ARJ, PAK, etc).  It will handle multiple nested
  84. archives of DIFFERENT types as well!
  85.  
  86. If VKill detects an infected file, a bad archive, or a suspicious file
  87. extension, the file is moved to a holding directory, and will remain there
  88. until you delete it.  This ensures that infected files and the like will not
  89. remain online for your users!
  90.  
  91. ***NOTE*** A Suspicious file extension is one that ends something that has
  92. not been defined in your configuration file.  (i.e. not a valid archive or a
  93. special extension type).
  94.  
  95. A sample DORINFO1.DEF file has been included to allow you to test in local
  96. mode operation.
  97.  
  98. ─────────────────────────────────────────────────────────────────────────────
  99. ■ CONFIGURATION ■
  100. ─────────────────────────────────────────────────────────────────────────────
  101.  
  102. The configuration file is where everything comes together.  You should create
  103. one .CTL file per node (i.e. VKILL1.CTL, VKILL2.CTL, etc), or simply use
  104. VKILL1.CTL for a one-node BBS system.
  105.  
  106.  
  107. BADPATH = This is the path of your holding directory for infected files, bad
  108.           archives, or files with suspicious extensions.
  109.  
  110. LOGPATH = This is the FULL PATH and FILENAME of the logfile generated and
  111.           maintained by VKill.  It is possible to run VKill on multinode
  112.           systems, by specifying a different configuration file per node.
  113.           If you are running a multinode BBS, just make each logfile unique.
  114.  
  115. DEBUG = This option will run VKill in debug mode.  When enabled, VKill will
  116.         log all pertinent debugging information to the logfile as well.  The
  117.         majority of the problems users have with VKill are directory/path
  118.         related.  This can be especially helpful when setting up VKill for
  119.         the first time.
  120.         
  121. DATECHECK = This option will allow you to provide a check for old or
  122.             out-of-date archives.  There are two methods of configuring the
  123.             datecheck system.  See the sample config file for more info.
  124.  
  125. ARCDEF = Signifies an ARChiver DEFinition.  See the config file for more info
  126.          on defining archivers.
  127.  
  128. SCANDEF = Signifies the Virus Scanner Definition.  See the config file for
  129.           more info on defining your scanner.
  130.  
  131. The remainder of the config file is pretty much self-explanatory.
  132.  
  133. ─────────────────────────────────────────────────────────────────────────────
  134. ■ COMMAND LINE ■
  135. ─────────────────────────────────────────────────────────────────────────────
  136.  
  137. VKill accepts the following parameters:
  138.  
  139.         -u[UPLOAD PATH] - Path to uploaded file
  140.         -f[FILENAME]    - Name of uploaded file
  141.         -e[EXTENSION]   - Extension of uploaded file
  142.         -c[VKILL PATH]  - Path to VKILLx.CTL file
  143.         -p[DORINFOPATH] - Path to the DORINFOx.DEF BBS Drop File
  144.         -t[TASKNUMBER]  - Maximus TaskNumber (1, 2, 3, etc)
  145.         -v[VIDEOMODE]   - 0 = Screen Writes, 1 = BIOS writes
  146.  
  147. When called from a VIRCHECK.BAT, it should look something like:
  148.  
  149.         VKILL.EXE -u%1 -f%2 -e%3 -cc:\max\vkill -pc:\max
  150.  
  151. since Maximus will pass the first 3 to VIRCHECK.BAT automatically.
  152.  
  153. ─────────────────────────────────────────────────────────────────────────────
  154. ■ COMING SOON TO VKILL! ■
  155. ─────────────────────────────────────────────────────────────────────────────
  156.  
  157. Along with the 3.0 release of the VKill system, a stand-alone utility system
  158. entitle VKMaint will accompany the VKill door.  This system will provide you
  159. with several niceties, comparable to other archive processing doors.  They
  160. include:
  161.  
  162. o  Archive conversion!
  163. o  GIF Integrity Testing! (Possibly)
  164. o  Remove BBS Advertisements!
  165. o  Replace Archive Comments!
  166. o  Much more!!
  167.  
  168. ─────────────────────────────────────────────────────────────────────────────
  169. ■ REGISTRATION ■
  170. ─────────────────────────────────────────────────────────────────────────────
  171. Currently, there is no registration fee for using VKill.  We have quite a bit
  172. in store for VKill in the future, so that may change.
  173.  
  174. For the latest version of VKill, or for tech support by BBS, call:
  175.  
  176. Scott Burkett,                  Bob Kruger
  177. Chris Brown                     BackWoods BBS
  178. Under The Nile!                 (706) 561-6106 9600 USR DS
  179. (706) 596-8126 9600 v.32        1:3613/10@fidonet
  180. 1:3613/12@fidonet
  181.  
  182.  
  183. Magic Name VKILL will get you the latest version!
  184.  
  185. ─────────────────────────────────────────────────────────────────────────────
  186.                       ■ END OF ALPHA DOCUMENTATION ■
  187. ─────────────────────────────────────────────────────────────────────────────
  188.